From 6ba5e6bb1acd161f0b81ae27e60afb37afc747a8 Mon Sep 17 00:00:00 2001
From: William Jon McCann <william.jon.mccann@gmail.com>
Date: Tue, 4 Feb 2014 17:38:09 -0500
Subject: [PATCH] docs: don't use <tag> docbook elements

---
 gtk/gtkapplicationwindow.c | 14 +++++++-------
 gtk/gtklabel.c             |  3 ++-
 gtk/gtkoverlay.c           |  2 +-
 gtk/gtkwindow.c            |  6 +++---
 4 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/gtk/gtkapplicationwindow.c b/gtk/gtkapplicationwindow.c
index ba99356c10..6ee95b1f13 100644
--- a/gtk/gtkapplicationwindow.c
+++ b/gtk/gtkapplicationwindow.c
@@ -111,16 +111,16 @@
  * ]|
  *
  * The XML format understood by #GtkBuilder for #GMenuModel consists
- * of a toplevel <tag class="starttag">menu</tag> element, which contains
- * one or more <tag class="starttag">item</tag> elements. Each
- * <tag class="starttag">item</tag> element contains
- * <tag class="starttag">attribute</tag> and <tag class="starttag">link</tag>
+ * of a toplevel `&lt;menu&gt;` element, which contains
+ * one or more `&lt;item&gt;` elements. Each
+ * `&lt;item&gt;` element contains
+ * `&lt;attribute&gt;` and `&lt;link&gt;`
  * elements with a mandatory name attribute.
- * <tag class="starttag">link</tag> elements have the same content
- * model as <tag class="starttag">menu</tag>.
+ * `&lt;link&gt;` elements have the same content
+ * model as `&lt;menu&gt;`.
  *
  * Attribute values can be translated using gettext, like other #GtkBuilder
- * content. <tag class="starttag">attribute</tag> elements can be marked for
+ * content. `&lt;attribute&gt;` elements can be marked for
  * translation with a <literal>translatable="yes"</literal> attribute.
  * It is also possible to specify message context and translator comments,
  * using the context and comments attributes. To make use of this, the
diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index ab769f1aae..6ca271c5e2 100644
--- a/gtk/gtklabel.c
+++ b/gtk/gtklabel.c
@@ -200,11 +200,12 @@
  *
  * Since 2.18, GTK+ supports markup for clickable hyperlinks in addition
  * to regular Pango markup. The markup for links is borrowed from HTML, using the
- * <tag>a</tag> with href and title attributes. GTK+ renders links similar to the
+ * `&lt;a&gt;` with href and title attributes. GTK+ renders links similar to the
  * way they appear in web browsers, with colored, underlined text. The title
  * attribute is displayed as a tooltip on the link.
  *
  * An example looks like this:
+ *
  * |[<!-- language="C" -->
  * gtk_label_set_markup (label, "Go to the <a href="http://www.gtk.org" title="&lt;i&gt;Our&lt;/i&gt; website">GTK+ website</a> for more...");
  * ]|
diff --git a/gtk/gtkoverlay.c b/gtk/gtkoverlay.c
index 4205153095..084db86f67 100644
--- a/gtk/gtkoverlay.c
+++ b/gtk/gtkoverlay.c
@@ -50,7 +50,7 @@
  *
  * The GtkOverlay implementation of the GtkBuildable interface
  * supports placing a child as an overlay by specifying "overlay" as
- * the "type" attribute of a <tag class="starttag">child</tag> element.
+ * the "type" attribute of a `&lt;child&gt;` element.
  */
 
 struct _GtkOverlayPrivate
diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index d70b74dc7b..a0377ce9ab 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -92,8 +92,8 @@
  * ## GtkWindow as GtkBuildable
  *
  * The GtkWindow implementation of the GtkBuildable interface supports a
- * custom <tag class="starttag">accel-groups</tag> element, which supports
- * any number of <tag class="starttag">group</tag> elements representing the
+ * custom `&lt;accel-groups&gt;` element, which supports
+ * any number of `&lt;group&gt;` elements representing the
  * #GtkAccelGroup objects you want to add to your window (synonymous with
  * gtk_window_add_accel_group().
  *
@@ -112,7 +112,7 @@
  * 
  * The GtkWindow implementation of the GtkBuildable interface
  * supports setting a child as the titlebar by specifying "titlebar" as
- * the "type" attribute of a <tag class="starttag">child</tag> element.
+ * the "type" attribute of a `&lt;child&gt;` element.
  */
 
 #define MNEMONICS_DELAY 300 /* ms */
-- 
2.30.2